home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Night Owl 6
/
Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso
/
019a
/
zce12.zip
/
ZCE&ZD.DOC
< prev
next >
Wrap
Text File
|
1991-12-09
|
58KB
|
1,757 lines
Zip Comment Editor and Zip Directory
=----------------------------------=
Users's Guide
Version 1.2
December 9, 1991
Copyright (C) 1990, 91, 92
by
Michael D. Boling
All Rights Reserved
COPYRIGHT NOTICE
ZCE & ZD Version 1.2 Copyright (c) 1990, 91, 92 by Michael D.
Boling, All Rights Reserved.
Zip Comment Editor (ZCE) and companion program Zip Directory (ZD)
allow editing and viewing of Zip file Comments.
ZCE and ZD have been released as shareware. This means the
version you have is fully functional. It also means that within
30 days you decide to use ZCE or ZD, you are obligated to pay a
licensing fee or stop using them.
ZCE and ZD are copyrighted and may be distributed only under the
following conditions:
No fee of over $10.00 may be charged for distribution. This
restriction applies only to physical copies and is not meant to
prevent distribution by telecommunication services.
All ZCE files must be distributed together in original, unaltered
form. This includes ZCE.EXE, ZD.EXE, ZCE&ZD.DOC, WHATSNEW.DOC,
ZCE.HLP, ZD.HLP, ZCE.CFG, FILES.LST and REGISTER.TXT.
You may use these programs at your own risk. They have been
tested by me on my own computer, but I will not assume any
responsibility for any problems which ZCE or ZD may cause you. If
you do encounter a problem, please let me know about it, and I
will do my best to verify and repair the error.
LIMITED WARRANTY
THE PROGRAMS CONTAINED IN THIS PACKAGE ARE PROVIDED "AS IS"
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
RISK RELATED TO THE QUALITY AND PERFORMANCE OF THE PROGRAMS IS ON
YOU. IN THE EVENT THERE IS ANY DEFECT, YOU ASSUME THE ENTIRE COST
OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION. SOME STATES DO
NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE
EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY GIVES YOU SPECIFIC
LEGAL RIGHTS WHICH VARY FROM STATE TO STATE.
It is expected that if you find ZCE and ZD useful, you must
register your copy. Registration entitles you to receive
information to remove trailing banners for this and one future
version of ZCE and ZD.
Table of Contents
What are ZCE and ZD? . . . . . . . . . . . . . . 1
ZCE Features . . . . . . . . . . . . . . . . . . 2
ZD Features . . . . . . . . . . . . . . . . . . . 2
Limitations of ZCE and ZD . . . . . . . . . . . . 2
ZCE & ZD System Requirements . . . . . . . . . . 2
ZCE & ZD Document Information . . . . . . . . . . 3
Using ZCE, <Zip Comment Editor> . . . . . . . . . 4
ZCE Command Line Examples . . . . . . . . . . . . 4
ZCE Command line syntax and switches . . . . . . 4
ZCE Command Line Display Options . . . . . . . . 4
Example ZCE Screen . . . . . . . . . . . . . . . 5
ZCE Main Window Editing Keys . . . . . . . . . . 6
ZCE Commands . . . . . . . . . . . . . . . . . . 7
F1 = On Line Help Window Functions . . . . . . . 7
F2 = Re-Read Zip Comments . . . . . . . . . . . . 7
F3 = Save Zip Comments . . . . . . . . . . . . . 7
F4 = New File Specification & Read Comments . . . 8
F5 = Copy Comment from Another File . . . . . . . 8
F6 = Import Zip Comments from a File . . . . . . 9
ZCE Import Configuration File . . . . . . . . . . 9
Import Commands . . . . . . . . . . . . . . . . . 9
Import Field Commands . . . . . . . . . . . . . . 9
Import Configuration Filename & Syntax . . . . . 10
Import Comments Filename . . . . . . . . . . . . 10
Import Starting Comment Column . . . . . . . . . 11
Import [E]dit/[A]uto . . . . . . . . . . . . . . 11
Import Comment Search [T]agged/[A]ll . . . . . . 11
Import Editing Commands . . . . . . . . . . . . . 11
Import Buffer Size . . . . . . . . . . . . . . . 12
MAIN ZCE Commands Continued . . . . . . . . . . . 13
F7 = Volume Label . . . . . . . . . . . . . . . . 13
F8 = Dos Shell . . . . . . . . . . . . . . . . . 13
F9 = Tag/Untag file for Import . . . . . . . . . 13
F10, Pull Down Menu . . . . . . . . . . . . . . . 13
Escape, Exit ZCE . . . . . . . . . . . . . . . . 15
Tab, Restore Comment . . . . . . . . . . . . . . 15
Ctrl+F1, ZCE Status Screen . . . . . . . . . . . 15
Ctrl+F2, Tag Files with Blank Comments . . . . . 15
Ctrl+F3, Write Filenames and Comments . . . . . . 15
Ctrl+F4, Change Filename . . . . . . . . . . . . 16
Ctrl+F5, Change Video Mode . . . . . . . . . . . 16
Ctrl+F9, Tag/Untag All Filenames . . . . . . . . 16
Ctrl+Enter, View Compressed Zip . . . . . . . . . 16
Using ZD, <Zip Directory> . . . . . . . . . . . . 20
ZD Command Line Syntax and Switches . . . . . . . 20
ZD Command Line Display Options . . . . . . . . . 20
ZD Command Line Color Options . . . . . . . . . . 20
ZD Command Line Sorting Options . . . . . . . . . 21
ZD Pause Control Options . . . . . . . . . . . . 21
ZD File Select Mode and Options . . . . . . . . . 21
ACKNOWLEDGEMENTS . . . . . . . . . . . . . . . . 22
Basic Libraries . . . . . . . . . . . . . . . . . 22
Future Versions of ZCE & ZD . . . . . . . . . . . 23
2.0 - What are ZCE and ZD? Page 1
---------------------------------------------------------------------------
2.0 What are ZCE and ZD?
Have you ever looked in a directory or a diskette and wondered
what was in those Zip files? I have on many occasions. That's
why I created ZCE and ZD.
ZCE and companion program ZD allow easy editing and displaying of
Zip Comments. Once Comments are added to Zip files, you won't
have to unzip them to know what programs are inside.
You usually look for the infamous readme.doc file to find out what
the programs inside the Zip file do. You go to all that trouble
and find out that this is not the Zip file you were looking for
anyway. Sound familiar? Very time consuming and nerve racking!
So I looked for a way to attach information about the programs
inside the Zip file to the Zip file itself. That is when I
learned about Zip Comments. Zip Comments allow attaching text to
the end of a Zip file. Zip comment text can anything you want.
Currently Zip Comments are primarily used by BBS operators to
store advertisements about there BBS. You may see this displayed
when you unzip a Zip file. So I decided to store information
about the programs inside the Zip file in the Zip comment.
I did this for awhile but I found adding Zip Comments manually to
many files using PKZIP to time consuming. So in October 1990 I
started writing Zip Comment Editor.
Note: Once Zip Comments are added, some disk cataloging programs
extract these Comments and add them to reports.
ZD is a directory listing utility with a twist. ZD quickly
displays all files and Zip Comments together in the same listing.
What are Zip's and what are Zip Comments anyway? PKZIP is a
program that reduces all file types of files into compacted binary
form and compacts multiple files in one Zip file. This is great
for upload/downloading to Bulletin Board Systems.
Please find/download or borrow find out about PKZIP. It may be
the most widely used program on pc's today. It certainly saves
lots of disk space. I encourage you to read the documentation
included with PKZIP. The current version of PKZIP is called
PKZ110.EXE and may be found on any BBS. It is the most widely
used program on pc's today.
ZCE and ZD are not for use by BBS SYSOP's to store adds in Zip
files, but for everyday users to store important information in
Zip Comments.
(1)PKZIP and PKUNZIP are registered trademarks of PKWARE Inc.
---------------------------------------------------------------------------
ZCE & ZD v1.2 Users' Manual 2.0 - What are ZCE and ZD?
Page 2 ZCE & ZD v1.2 Users' Manual
---------------------------------------------------------------------------
2.1 ZCE Features
Display and Edit Zip Comments
Save Comments into Zip Files
On Line Help
Re-Read Zip Comments
Copy Comment from Another File
Import Comments from External File
Modify Floppy Volume Label
Shell to Dos
Tag/Untag Files for Comment Import
EGA/VGA 43/50 line support
Write List of Filenames and Comments to a File
Rename a File
Pull Down Menu
View Compresses Zip File Contents
Uncompress Zip File using PKUNZIP.EXE and Redirect to (2)LIST.COM
Extract Single or Tagged files from Current Zip File to Local
Directory
Delete Single or Tagged files from Current Zip File
Import Comments from a FIle Stored Inside a Zip File
(2)LIST.COM is copyright by Vernon D. Buerg.
2.2 ZD Features
Quickly Display File Names and Zip Comments
Display File Date, Time, Size and Zip Comment
On Line Help
Color Options
File Sorting Options
EGA/VGA 43/50 Line Support
Set an Environment Variable to Selected Filename for use in
batch files
2.3 Limitations of ZCE and ZD
Current limit is set to 512 files in any one directory.
ZCE has been tested with up to 350 Zip Comments.
2.4 ZCE & ZD System Requirements
ZCE and ZD have been designed to work properly on the (3)IBM-PC,
IBM-XT, IBM-AT, PS/2, and any close compatible. ZCE and ZD
require about 256K of ram to execute. ZCE and ZD require PC/MS
DOS version 2.1 or later.
(*) IBM-PC, IBM-XT, IBM-AT are trademarks of International
Business Machines Corporation, Boca Roton, Florida.
---------------------------------------------------------------------------
2.4 - ZCE & ZD System Requirements ZCE & ZD Users' Manual
2.5 - ZCE & ZD Document Information Page 3
---------------------------------------------------------------------------
2.5 ZCE & ZD Document Information
This document has been formatted to 66 lines per page.
Document Key:
^ = The Control key, i.e. ^Home = Control + Home.
@ = The Alt key, i.e @F4 = Alt + Function key 4
# = The Shift key, i.e. #F1 = Shift + Function key 1
---------------------------------------------------------------------------
ZCE & ZD v1.2 Users' Manual 2.5 - ZCE & ZD Document Information
Page 4 ZCE & ZD v1.2 Users' Manual
---------------------------------------------------------------------------
3.0 Using ZCE, <Zip Comment Editor>
3.1 ZCE Command Line Examples
ZCE
By itself on the command line will search the current directory
for *.ZIP and display one screen of filenames and Comments sorted
by filename.
ZCE FOO*
ZCE will search for FOO*.ZIP in the current directory
ZCE A:
ZCE will search drive a: for *.ZIP
ZCE C:\DOS
ZCE will search for a directory called DOS. If the directory DOS
exists then ZCE will search for C:\DOS\*.ZIP. If the directory
does not exist then ZCE will look for the filename of DOS.
Once ZCE determines that the input filename specification is legal
ZCE will display a window showing the Zip files being searched for
Comments.
Escape may be pressed to interrupt ZCE while reading Comments. A
query box will be displayed to continue reading Zip Comments.
Valid responses are:
Y/N for Yes or No Arrow keys move highlighted response. Enter
selects Left mouse button click on item if a mouse is detected.
ZCE will display an error message if the command line arguments
are invalid or if there is a problems opening or reading the files
found. The error will indicate the problem.
3.2 ZCE Command line syntax and switches
Zip Comment Editor Syntax, ZCE <drive:\path\filenames> [/options]
Drive must be a Valid Dos Drive, i.e. A: or B: or C:
Path must be in Valid Dos syntax, i.e. \dos\ or \wp50\letters\
Filenames may contain Wildcards, i.e. *.ZIP or H?
3.3 ZCE Command Line Display Options
/M Force monochrome display
/EGA Display 43/50 lines if EGA or VGA detected.
/NS Do not restore original dos screen
---------------------------------------------------------------------------
3.3 - ZCE Command Line Display Options ZCE & ZD Users' Manual
3.4 - Example ZCE Screen Page 5
---------------------------------------------------------------------------
/? Display command line switches
both / and - may be used for ZCE and ZD command line switches.
3.4 Example ZCE Screen
Disk space
Volume Label
Date | |
Version | Time | Drive | Monitor
| | | | | | |
+-----------------------------------------------------------------------+
|Zip Comment Editor v1.2 10/26/91 5:27pm 14.6M E: QUICKBASIC VGA |
+-----------------------------------------------------------------------+
|BACKUP.ZIP |Backup of c:\dos\ 10/24/90 |
|TEST100.ZIP |$$$ Zip Comment to Long, Not Found or Zip Corrupted $$$ |
|TEST101.ZIP | |
|VIDEO.ZIP | |
| | |
+-----------------------------------------------------------------------+
|F1=Help F2=Read F3=Save F4=Read F5=Copy F6=Import F7=Vol F8=Dos ... |
+-----------------------------------------------------------------------+
ZCE will display the names of Zip files being scanned for Comments
or an error message if a problem occurs. ZCE will display in
color or monochrome and 25, 43 or 50 lines if the appropriate
video card is detected. ZCE will automatically tag all files with
blank Comments for other functions described later.
All Zip files detected will be displayed on the left side with Zip
Comments on the right. The comment will have all control
characters removed and truncated to 65 characters. If you want to
preserve any Zip comment, simply do not edit the comment. ZCE
will only write modified Comments.
If ZCE had trouble locating the Zip comment, the message,
$$$ Zip Comment to Long, Not Found or Zip Corrupted $$$
will be displayed as the comment. Bad Zip file Comments may not
be edited or saved. Either the Zip file is corrupted or the Zip
comment is very long. ZCE only reads the last 2024 bytes of the
file to find the comment. Usually deleting the Zip comment will
allow ZCE to read it correctly. Use the -Z command in PKZIP to
delete the Zip comment. See ZIPFIX.BAT for an automated way to
remove Comments from all Zip files in a directory. If you do this
while in the dos shell make sure you execute the re-read Zip
Comments command <F2> when you return to ZCE!!! Make sure you
have written out all modified Comments first! See Shell command.
ZCE will check each file size for any changes and display an error
message if a change is detected.
A Function key list will be displayed on the bottom line of the
screen.
---------------------------------------------------------------------------
ZCE & ZD v1.2 Users' Manual 3.4 - Example ZCE Screen
Page 6 ZCE & ZD v1.2 Users' Manual
---------------------------------------------------------------------------
3.5 ZCE Main Window Editing Keys
Insert Toggles the insert mode and over-type mode
Delete Delete character at cursor
Backspace Destructive backspace
Left Move the cursor to the left
Right Move the cursor to the right
Up Move cursor to the next comment
Down Move the cursor to the previous comment
Return Same as Down Arrow
Home Move the cursor to the beginning of the field
End Move the cursor to the end of the field
^Home Move cursor to the start and erase the field
^End Erase from the cursor to the end of the field
^BackSpace Erase from the cursor to the start of the field
@Home Scroll to top comment
@End Scroll to bottom comment
Tab Restore comment, until up/down move
---------------------------------------------------------------------------
3.5 - ZCE Main Window Editing Keys ZCE & ZD Users' Manual
4.0 - ZCE Commands Page 7
---------------------------------------------------------------------------
4.0 ZCE Commands
4.1 F1 = On Line Help Window Functions
ZCE will search for the file ZCE.HLP in the current directory and
all directories in the current dos path. If the help file is not
found an error message will be displayed otherwise the help file
will be displayed.
PgUp Scrolls up one page
PgDn Scrolls down one page
Up Scrolls up one line
Down Scrolls down one line
Left Sweeps left 15 characters
Right Sweeps right 15 characters
Home Go to far left column
^Home Go to top of file
Escape Exit Help
Mouse:
Next Page Click the left mouse button on <PgDn>.
Previous Page Click the left mouse button on <PgUp>.
Next Line Click left mouse button on the Down Arrow.
Previous Line Click left mouse button on the Up Arrow.
Move Pointer The position marker in the scroll bar approximates
the position within the help file. To move to
another relative position, place mouse cursor on
scroll bar position marker and press left mouse
button.
First Page Click left mouse on <^HOME>.
Exit Click right mouse button.
4.2 F2 = Re-Read Zip Comments
This command causes ZCE to read Comments from Zip files using the
current drive, path and file specifications. This command allows
you to read a new disk without exiting ZCE. If any Comments have
been modified ZCE will warn you to save them or lose all changes.
4.3 F3 = Save Zip Comments
This command saves any modified comment to the file from the
drive and path it was read from. Any errors encountered will
cause ZCE to display an error message of the problem. ZCE
verifies all data writes and checks all file sizes for changes
before writing. ZCE will not change file dates or times.
---------------------------------------------------------------------------
ZCE & ZD v1.2 Users' Manual 4.3 - F3 = Save Zip Comments
Page 8 ZCE & ZD v1.2 Users' Manual
---------------------------------------------------------------------------
4.4 F4 = New File Specification & Read Comments
An input prompt window will pop up requesting a new file
specification. ZCE will then check this entry and give errors if
the input could not be parsed or if files could be found.
Wildcard characters are accepted. i.e. * or *.Zip or c:\dos\app?
are all valid examples. ZCE will display an error if an invalid
drive, path or file specification are entered. Pressing escape
will cancel this command. The same rules apply here as the
command line file specification when starting ZCE.
4.5 F5 = Copy Comment from Another File
If more than one file comment is available in the main ZCE window,
ZCE will pop up a list of current Comments which may be used for
the current file comment. Use the arrow keys and press enter to
select. Escape will abort this command. Home/End keys will move
highlight bar to the first/last items in the list. If a mouse is
detected the mouse pointer will be displayed. Move the mouse
pointer to an item and select using the left button. The right
mouse button or pressing escape will abort this command.
---------------------------------------------------------------------------
4.5 - F5 = Copy Comment from Another File ZCE & ZD Users' Manual
4.6 - F6 = Import Zip Comments from a File Page 9
---------------------------------------------------------------------------
4.6 F6 = Import Zip Comments from a File
This command searches a file for Zip file Comments. The search
routine will use the filenames without extension as the search
strings. Filenames like TEST or VIDEO may be found hundreds of
times in a single file. It is best to manually add Comments to
common filenames. Searching list may consist of ALL or Tagged
filenames.
There are two different modes to search a file for Comments.
Edit mode will search the import file for a match and if found an
edit screen window will pop and allow editing of the comment.
Auto mode searches as in Edit mode but Comments are automatically
extracted using the starting comment column as the left column of
the comment. Auto mode only works if the filename and comment are
on the same line.
If a comment exists and a new comment is found in Edit or Auto
mode a pop up window will appear for you to choose one.
4.6.1 ZCE Import Configuration File
Example import screen:
┌[ Import Comments from a File ]─────────────────────────────────────────┐
│ │
│ Config File: ZCE.CFG░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
│ │
│ Comments File: BBS.LOG │
│ │
│ Col: 30 Comment Edit/Auto: E Tagged/All: T Input Buffer: 128 │
│ │
│ │
│ │
└────────────────────────────────────────────────────────────────────────┘
4.6.2 Import Commands
F1 Help
F4 Add Filename to Import File List if less than 9.
F5 Select Current Import File List
F8 Save Settings file
F9 Read Settings file
F10 Start Import
4.6.3 Import Field Commands
PgUp Move to the first field
PgDn Move to the last field
Up Move up one field
Down Move down one field
Left Move left one field
---------------------------------------------------------------------------
ZCE & ZD v1.2 Users' Manual 4.6 - F6 = Import Zip Comments from a File
Page 10 ZCE & ZD v1.2 Users' Manual
---------------------------------------------------------------------------
Right Move right one field
Home Move to the beginning of the field
End Move to the end of the field
Insert Toggle between insert and overstrike mode
Del Delete the character under the cursor
BackSpace Delete the character to the left of the cursor
^Right Move right one word
^Left Move left one word
^End Delete from the cursor to the end of the field
Enter Move to the next field
Tab Move to the next field
#Tab Move to the previous field
Escape Abort Import function
Mouse:
Left Move to position in field
Right Abort Import function
4.6.4 Import Configuration Filename & Syntax
The file ZCE.CFG contains the default import configuration. ZCE
will search the current directory and all directories in the Dos
Path for the file ZCE.CFG. If not found an error message will be
displayed and default values will be assigned.
ZCE.CFG Import configuration file syntax and defaults.
start_col=30
edit/auto=E
tag/all=T
current_comments_file=FOO.BAR
comments_file1=C:\DOS\BBS.LOG
comments_file2=C:\DOS\BBS.ZIP,TEST.LOG
comments_file#=filename.zip,filename
comments_file#=filename
import_buffer=256
Where # = 1 to 9 only, No Spaces Allowed. Compressed file must
have a .ZIP extension and Import file must exist inside of
the compressed file.
4.6.5 Import Comments Filename
This is the filename of the file containing the Comments for
import. This file must be in ascii format. If this filename is
entered as a .Zip extension followed by a comma and another
filename, ZCE will enter Zip Import mode.
In Zip Import mode ZCE will try to uncompress the second file from
the first and use the extracted file as the Import file. This may
sound complicated but it really isn't.
If C:\DOS\BBS.ZIP,TEST.LOG is entered as the Comments File then
---------------------------------------------------------------------------
4.6 - F6 = Import Zip Comments from a File ZCE & ZD Users' Manual
4.6 - F6 = Import Zip Comments from a File Page 11
---------------------------------------------------------------------------
ZCE will create a subdirectory and call PKUNZIP.EXE to uncompress
TEST.LOG. If successful the file TEST.LOG will be used as the
Comments File. See View Compresses Zip File section for more
details. This special option basically allows you to leave your
BBS listings in compressed format and have ZCE temporally
uncompress a copy to import Comments.
NOTE: The only way to add as comma to the Comments file list is
to type in a comma on the Comments File line and then press F4. A
text editor may also be used to edit ZCE.CFG directly.
4.6.6 Import Starting Comment Column
This number should indicate the starting column of the comment
inside the Comments file. This option is only used for (A)UTO
mode.
4.6.7 Import [E]dit/[A]uto
This is the import type. E for EDIT and A for Automatic. ZCE can
read single line Comments from a file in AUTOMATIC mode or up to
240 characters into a small line editor in EDIT mode.
AUTOMATIC mode searches the Comments file for a line containing
the filename portion like DOCS in DOCS.ZIP. This allows the ZCE
to find Comments in all type of BBS (Bulletin Board System) file
listings. ZCE will use the comment found on the first line that
contains the filename string. This may not be the correct
comment. Make sure you check the Comments after ZCE is finished.
In EDIT mode (default) ZCE will pop up a line editor with three
lines of data starting on the line that the filename is located.
You can now edit the comment to your liking. Just remember that
the finished comment must be no longer than 65 characters long.
ZCE will truncate longer Comments. A marker is displayed at
column 65 to indicate where truncation will occur.
4.6.8 Import Comment Search [T]agged/[A]ll
Importing of Comments may be performed on tagged or all files.
ZCE will only search for Comments of tagged files if T is entered.
T is the default. This will speed up comment imports.
4.6.9 Import Editing Commands
F1 Help
Escape Skip the current comment and will keep the current
filename on the search list.
Enter Accept, Truncates the current comment to 65
characters and removes the filename from the search
list.
---------------------------------------------------------------------------
ZCE & ZD v1.2 Users' Manual 4.6 - F6 = Import Zip Comments from a File
Page 12 ZCE & ZD v1.2 Users' Manual
---------------------------------------------------------------------------
F10 Abort, Terminate Import function. ZCE will ask if
you really want to Abort. ZCE will still use all
previously found Comments even if Abort is selected.
Insert Toggle between insert and overstrike mode
Del Delete the character under the cursor
BackSpace Delete the character to the left of the cursor
^Right Move right one word
^Left Move left one word
^End Delete from the cursor to the end of the field
Enter Move to the next field
Tab Move to the next field
#Tab Move to the previous field
Escape Abort Import function
Mouse:
Left Move to position in field
Right Abort Import function
4.6.10 Import Buffer Size
The Import buffer size is the number of lines read each time there
is a search. This number my be from 32-384. The higher the
number the faster ZCE cans search because of less disk activity.
If there is not enough memory available ZCE will display an error
message. Reducing the number of Zip files or reducing the import
buffer size may allow ZCE to perform the import.
---------------------------------------------------------------------------
4.6 - F6 = Import Zip Comments from a File ZCE & ZD Users' Manual
4.7 - F7 = Volume Label Page 13
---------------------------------------------------------------------------
MAIN ZCE Commands Continued
4.7 F7 = Volume Label
If the current or selected drive is A: or B: then ZCE will pop up
an input window for the new volume label. Only 11 characters will
be allowed. ZCE will only allow characters that are valid for
volume labels.
4.8 F8 = Dos Shell
Spawns another COMMAND.COM leaving ZCE in memory. About 200K is
used by ZCE. If the system crashes or is re-booted all editing of
Comments will be lost unless saved.
The prompt is modified to remind you to type EXIT to return to
ZCE.
Enter 'EXIT' to Return to ZCE
C:\QB\ZCE>
If you Shell to Dos and modify a Zip file in any way or delete
files from the Zip File inside the View Zip function, the comment
location in the file will be altered and ZCE will display an error
message. At this point the modified comment can never be saved.
Whenever you return to ZCE from the shell always re-read the Zip
file Comments using the <F2> key if any Zip files were modified.
Make sure you write out any modified Comments first! This will
update comment positions to ZCE and allow correct comment update.
4.9 F9 = Tag/Untag file for Import
This function will Tag or Untag a file. The Import function
allows importing Comments for all or tagged files.
4.10 F10, Pull Down Menu
If F10 is pressed in the main ZCE window a pull down menu will
appear. The Pull Down Menu uses about 2000 bytes if string space.
Pull Down Menu Keys:
Down-Arrow Pulls down a window if one is not already down.
Otherwise, it moves the highlight bar down one
selection within the window.
Up-Arrow Moves the selection bar up one item within a
window. If a window is not pulled down, this key
has no function.
Left-Arrow If a window is not pulled down, the selection bar
is moved to the next bar item to the left. If a
---------------------------------------------------------------------------
ZCE & ZD v1.2 Users' Manual 4.10 - F10, Pull Down Menu
Page 14 ZCE & ZD v1.2 Users' Manual
---------------------------------------------------------------------------
window is pulled down, the window under the next
bar menu item on the left is pulled down.
Right-Arrow If a window is not pulled down, the selection bar
is moved to the next bar item to the right. If a
window is pulled down, the window under the next
bar menu item on the right is pulled down.
Alt-Highlighted Key
If no windows are pulled down, holding down the Alt
key while pressing a key highlighted on the menu
bar will pull down the window under that item.
Highlighted key
If a window is pulled down, pressing a highlighted
key will select that item in the menu.
Escape If a window is pulled down, it will be erased and
only the bar menu and the description line will be
active. If a window is not pulled down, the
pulldown menu will be exited.
Enter If a window is not currently pulled down, the
window under the highlighted bar menu item will be
displayed. If a window is pulled down, the
highlighted item within the window will be
selected.
Mouse Clicking the left button on a bar menu item will
pull down the window for that item. Clicking the
left button on an item within a window will select
that item. Clicking the right button will exit the
pull down menu.
---------------------------------------------------------------------------
4.10 - F10, Pull Down Menu ZCE & ZD Users' Manual
4.11 - Escape, Exit ZCE Page 15
---------------------------------------------------------------------------
Pulldown menu contents:
File Comment
┌──────────────────────┐ ┌──────────────────────┐
│ Help F1 │ │ Copy F5 │
│ Read F2 │ │ Restore Comment Tab │
│ Save F3 │ └──────────────────────┘
│ New FileSpec F4 │
│ Import F6 │ Tag
│ voLume F7 │ ┌──────────────────────┐
│ Dos Shell F8 │ │ Tag cUrrent F9 │
│ Write Ctrl+F3 │ │ Tag All Ctrl+F9 │
│ reName Ctrl+F4 │ │ Tag Empty Ctrl+F2 │
│ View Ctrl+Enter │ └──────────────────────┘
│ eXit Escape │
└──────────────────────┘ Options
┌──────────────────────┐
│ Status Ctrl+F1 │
│ Display Ctrl+F5 │
└──────────────────────┘
4.11 Escape, Exit ZCE
A message will be displayed asking if you would like to exit ZCE.
Default is NO. Arrow keys move between No and YES. The enter key
will select. Y or N will also select. If you have a mouse the
left button may be used to click on the Y or N.
4.12 Tab, Restore Comment
This command will restore the current comment only if the cursor
is not moved to another comment. i.e. up or down.
4.13 Ctrl+F1, ZCE Status Screen
This command will display the internal ZCE variables. This
command is mainly used for development of ZCE. I am documenting
this just in case you run into it.
4.14 Ctrl+F2, Tag Files with Blank Comments
This command will tag all files with blank Comments.
4.15 Ctrl+F3, Write Filenames and Comments
This command will write tagged filenames and Comments to a user
specified file. A filename input window will pop up requesting
the file to write the filenames and comments. If the file exists
or if problems occurred while writing the data to the file error
messages will be displayed.
The output file is formatted with filename and comment on the same
---------------------------------------------------------------------------
ZCE & ZD v1.2 Users' Manual4.15 - Ctrl+F3, Write Filenames and Comments
Page 16 ZCE & ZD v1.2 Users' Manual
---------------------------------------------------------------------------
line as they appear in ZCE. Many programs can use this file
to as input into other database's. i.e. BBS file lists.
4.16 Ctrl+F4, Change Filename
This command allows you to change the current filename. A pop up
input window will appear prompting for new filename. Only
characters valid for filenames will be allowed. If successful the
filename will be changed. An error message will be displayed if
the rename was not successful.
4.17 Ctrl+F5, Change Video Mode
This command toggles between 25/43/50 line mode if ZCE detects
that your graphics card supports these modes.
4.18 Ctrl+F9, Tag/Untag All Filenames
All files will be tagged or untagged unless they have been
displayed as bad or unfound.
4.19 Ctrl+Enter, View Compressed Zip
If Ctrl+Enter is pressed the current Zip file will be scanned for
all files. A Pick List will be displayed of all files found. If
a file is selected by pressing enter, a subdirectory named
$%ZCE will be created under the current directory. An optional
environment variable ZCEWORK may be set to a directory and
will be used instead of the current directory. This has two
benefits. This directory may be a ramdisk or a drive with more
space available.
i.e. at the command line type the following or add to
Autoexec.bat.
set ZCEWORK=g:\
If this directory g:\ is a valid dos drive and directory ZCE will
create the temporary there. This allows ZCE to use a ramdisk.
PKUNZIP.EXE will be called to extract the chosen file, then
LIST.COM will be called to display the file. Once LIST is
finished, control will be returned to ZCE. Both PKUNZIP.EXE and
LIST.COM must be in a directory in the DOS path. ZCE will display
errors if the subdirectory and temporary file could not be created
or removed and if PKUNZIP.EXE or LIST.COM could not be found in
the DOS path.
LIST.COM is the most powerful and widely used shareware file
listing program available. Please read the LIST documentation for
operation details. Look for it on your local BBS.
Recursive Zip viewing is not supported. This means that selecting
---------------------------------------------------------------------------
4.19 - Ctrl+Enter, View Compressed Zip ZCE & ZD Users' Manual
4.19 - Ctrl+Enter, View Compressed Zip Page 17
---------------------------------------------------------------------------
a Zip file inside a Zip file will not list a second list but only
extract and display the Zip file in binary.
When in the Dos Shell there must be enough memory to execute
PKZIP, PKUNZIP and LIST programs.
Other Zip View Compressed Commands:
F1 On Line Help
E Extract highlighted file to current directory
Ctrl+E Extract tagged files to current directory
D Delete highlighted file from current Zip file
Ctrl+D Delete tagged files from current Zip file
SpaceBar Tag/Untag highlighted file
S Sort by [D]ate, [E]xtension, [F]ilename or [P]ath.
Press D, E, F or P. Escape aborts the sort function.
Right Mouse Tag/Untag current file
Left Mouse Exit View Zip
---------------------------------------------------------------------------
ZCE & ZD v1.2 Users' Manual 4.19 - Ctrl+Enter, View Compressed Zip
Page 18 ZCE & ZD v1.2 Users' Manual
---------------------------------------------------------------------------
Example View Compressed Zip file listing:
Filename Compressed Size Compression Method
/ / /
/ Original Size / Date Time / Path Scroll Bar
/ / / / / / / /
┌──────────────────────────────────────────────────────────────────┐
│ 25 .BAT 26 26 Sep-30-91 12:21 Stored DOS/ ░
│ 43 .BAT 15 15 Sep-05-91 13:10 Stored DOS/ ▓
│ 50 .BAT 26 26 Sep-05-91 13:10 Stored DOS/ ░
│ A2ZIP .BAT 138 105 Sep-05-91 13:10 Shrunk DOS/ ░
│ ARC2LZH .BAT 287 225 Sep-05-91 13:10 Shrunk DOS/ ░
│ ARC2ZIPA.BAT 564 290 Sep-05-91 13:10 Imploded DOS/ ░
│ ASK .BAT 37 37 Sep-05-91 13:10 Stored DOS/ ░
│ AUTOEXEC.BAT 749 418 Nov-18-91 7:29 Imploded ░
│ BACKUP .BAT 714 356 Jun-26-91 3:00 Imploded FB/ ░
│ BAT .BAT 5 5 Apr-18-91 17:48 Stored XTG/ ░
│ BBSLOG .BAT 62 59 Sep-05-91 13:10 Shrunk DOS/ ░
│ BD-PIF .BAK 416 121 Oct-04-91 13:07 Imploded QEMM/ ░
│ CALC .BAT 60 59 Sep-05-91 13:10 Shrunk DOS/ ░
│ CASE1 .BAT 387 264 Sep-05-91 13:10 Imploded DOS/ ░
│ CLOSED .BAT 57 56 Nov-08-91 7:32 Shrunk DOS/ ░
│ COM .BAT 5 5 Apr-18-91 17:48 Stored XTG/ ░
│ COMSPEC .BAT 146 119 Sep-27-91 7:25 Shrunk DOS/ ░
│ CONF .BAT 24 24 Jul-22-91 9:34 Stored FB/ ░
└──────────────────────────────────────────────────────────────────┘
If the path is to long to fit on the display the original and compressed
file sizes will be removed from the display list.
┌──────────────────────────────────────────────────────────────────────┐
│ FOO . Nov-19-91 9:44 Stored QB/ZCE/ ░
│ FOO .BAT Sep-25-91 11:29 Stored QB/RFP/ ▓
│ TEST .BAK Nov-19-91 10:28 Stored QB/ZCE/REALLY/LONG/PATH/LONG/ ░
│ TEST .BAK Oct-26-91 15:58 Imploded QB/ZCE/DOC/ ░
│ TEST .BAS Apr-09-91 7:19 Imploded PBCLON14/ ░
│ TEST .BAS Sep-25-91 14:09 Imploded QB/RFP/ ░
│ TEST .BAT Jun-04-91 14:12 Stored QB/ZCE/TEST/ ░
│ TEST .BAT Oct-26-91 16:17 Shrunk QB/ZCE/ ░
│ TEST .BAT Sep-25-91 7:54 Stored QB/RFP/ ░
│ TEST .BQL Apr-09-91 7:20 Shrunk PBCLON14/ ░
│ TEST .BQL Sep-25-91 11:20 Shrunk QB/RFP/ ░
│ TEST .DEC Sep-25-91 11:19 Imploded QB/RFP/ ░
│ TEST .DOC Oct-18-91 9:38 Shrunk QB/ZCE/ ░
│ TEST .DOC Oct-26-91 15:59 Imploded QB/ZCE/DOC/ ░
│ TEST .EXE Sep-25-91 13:31 Imploded QB/RFP/ ░
│ TEST .EXT Sep-25-91 11:20 Imploded QB/RFP/ ░
│ TEST .LNK Sep-25-91 10:05 Shrunk QB/RFP/ ░
│ TEST .OBJ Sep-25-91 13:31 Imploded QB/RFP/ ░
└──────────────────────────────────────────────────────────────────────┘
View Compressed file commands when ZCE shells to DOS and executes
PKZIP, PKUNZIP or LIST.
View Zip File, Enter
PKUNZIP -O ZIPFILE DIR\FILE
---------------------------------------------------------------------------
4.19 - Ctrl+Enter, View Compressed Zip ZCE & ZD Users' Manual
4.19 - Ctrl+Enter, View Compressed Zip Page 19
---------------------------------------------------------------------------
Where -O overwrites any existing file with the same name. ZIPFILE
is the name of the Zip file to be uncompressed by PKUNZIP. DIR is
the path stored inside the Zip file. FILE is the name of the file
that is uncompressed.
LIST DIR\FILE
Where DIR defaults to $%ZCE. If the ZCEWORK environment
variable is set then this will be prepended to the $%ZCE
directory. i.e LIST K:\WORK\$%ZCE\FILE if ZCEWORK is set to
K:\WORK. FILE is the name of the file to view and the same as the
file unzipped above.
Delete File, D
PKZIP -D ZIPFILE PATH\FILE
Where -D stands for delete file. ZIPFILE is the name of the Zip
file the file will be deleted from. PATH is the OPTIONAL path
stored inside the Zip file and FILE is the name of the file to be
deleted.
Extract Tagged Files, Ctrl+E
PKUNZIP ZIPFILE @ZCE.$$$
Where ZIPFILE is the name of the Zip file to be uncompressed.
ZCE.$$$ is the file created in the local directory containing a
list of tagged files to be extracted.
Delete Tagged Files, Ctrl+D
PKZIP -D ZIPFILE @ZCE.$$$
Where ZIPFILE is the name of the Zip file to be modified. ZCE.$$$
is the file created in the local directory containing a list of
files to be deleted.
Extract File, E
PKUNZIP -O ZIPFILE DIR\FILE
Where -O stands for overwrite existing file with same name.
ZIPFILE is the name of the Zip file the selected file will be
extracted from. PATH is the optional path stored inside the Zip
file and FILE is the name of the file to be extracted.
---------------------------------------------------------------------------
ZCE & ZD v1.2 Users' Manual 4.19 - Ctrl+Enter, View Compressed Zip
Page 20 ZCE & ZD v1.2 Users' Manual
---------------------------------------------------------------------------
5.0 Using ZD, <Zip Directory>
5.1 ZD Command Line Syntax and Switches
ZD /?
Entering ZD /? will display command help information.
ZD /w /sf
Display in wide format and sort by filename
ZD *.Zip /ega /ss /zc=3 /np
Display all files with .Zip extension in 43 or 50 line mode sorted
by file size and shows the Zip Comments in cyan on black and does
not pause with each screen of text.
5.2 ZD Command Line Display Options
/? Display Help Screen
/W Wide Format, Shows date, Time and File Size. The Zip
comment is displayed on the next line.
/NP No Pause for Full Screen
/NS No Save and Restore Screen
/EGA Display 43/50 Lines if EGA/VGA Detected
/M Force Monochrome Display
/L Lower Case File Names
/VC View Compressed Files
The new View Compressed [/VC] option will displays compressed file
contents for .ZIP, .ARC, .PAK and .LZH file extensions.
5.3 ZD Command Line Color Options
/ZF=# Zip Filename Colors
/ZC=# Zip Comment Colors
/OF=# Other Filename Colors
/TC=# Text Colors
/HC=# Header Colors
/BG=# Background Color
/VC=# View Compressed Colors
/A Alternate Color Set
The color codes are:
0 Black 2 Green 4 Red 6 Brown
1 Blue 3 Cyan 5 Magenta 7 White
Foreground color:
Select the color number
For high intensity (bright or light), add 8
For Blinking, add 128
---------------------------------------------------------------------------
5.3 - ZD Command Line Color Options ZCE & ZD Users' Manual
5.4 - ZD Command Line Sorting Options Page 21
---------------------------------------------------------------------------
Example:
Blinking, high-intensity cyan is 3+8+128 = 137
Background color:
Select the Color Number
Multiply it by 16
Add it to the Foreground Color
Example:
Blinking, high-intensity cyan on blue is 137+(1*16) = 153
5.4 ZD Command Line Sorting Options
/SF Sort by Filename
/SS Sort by Size
/SE Sort by Extension
/SD Sort by Date
5.5 ZD Pause Control Options
F1 On Line Help
B/PgUp Backup Listing One Page
N/Home Re-Read disk
S Toggle File Select Mode
F4 Enter New File Specification
U Create Directory, Unzip Selected File and Exit
Escape Quit ZD
The file ZD.HLP file must be in the current directory or in a
directory in the Dos Path.
5.6 ZD File Select Mode and Options
File Select mode highlights a file and allows cursor movement of
the highlight. IF ENTER is pressed the ZDSELECT environment
variable will be set to the name of highlighted file. If escape
is pressed while in file select mode then ZDSELECT will not be
set or modified.
/SEL Turn on File Select Mode when ZD starts
/FO Set ZDSELECT to filename without extension
/ME Update Master environment. Default is parent.
/LE Update Local environment.
/DEBUG Shows environment information for file select mode.
UNZIP.BAT shows an example application for file select mode.
---------------------------------------------------------------------------
ZCE & ZD v1.2 Users' Manual 5.6 - ZD File Select Mode and Options
Page 22 ZCE & ZD v1.2 Users' Manual
---------------------------------------------------------------------------
6.0 ACKNOWLEDGEMENTS
Special thanks to my wife Lynette for putting up with all the time
I spend on these projects.
Special Thanks to Phil Katz of PKWARE for releasing the Zip file
formats. Without this many utilities like ZCE and ZD could not be
possible.
6.1 Basic Libraries
Here is a list of the QuickBasic Libraries and programming aids
used to create ZCE and ZD.
PBCLONE (Pro Bas Clone) by Thomas G. Hanlin III
3544 E. Southern Ave. #104
Mesa, AZ 85204
MicroHelp Muscle
4636 Huntridge Drive
Rosewell, Georgia 30075
(404) 552-0565
QB4BAS Version 4.6 by Harold Thomson
7437 Burnway Drive
Orlando, Florida 32819
(407) 351-3737
Basic Window Tools Version 8.0 by James P. Morgan
5226 Via Hacienda #115
Orlando, Florida 32809
The QBNews International QuickBasic Electronics Newsletter.
By Clearware Computing
P.O. Box 507
Sandy Hook, CT 06482
QBNews is available for download from Microhelp BUG BBS (404)
552-0567 or Crescent Software BBS (203) 426-5958.
PKware Inc.
7032 Ardara Avenue
Glendale, WI 53209
(414) 352-3670
Quick Basic archive file viewer for MS-DOS machines by Dick
Dennison, 914-374-3903 24 hrs
The Buerg Utilities, LIST.COM
Buerg Software
139 White Oak Circle
Petaluma, CA 94952
(707) 778-1811 between 10 am and 5 pm Pacific time.
DAZZLING screen restore, appeared in QBNews
---------------------------------------------------------------------------
6.1 - Basic Libraries ZCE & ZD Users' Manual
7.0 - Future Versions of ZCE & ZD Page 23
---------------------------------------------------------------------------
Lawrence Stone
P.O. Box 5715
Charleston, OR 97420
The latest ZCE and ZD and most of the libraries listed above are
available to all registered users from the Vanguard BBS,
(408) 988-0288.
7.0 Future Versions of ZCE & ZD
Color Configuration
Multiple line Comment Editing
Improved Documentation
Other archive types
All mouse & window support
Graphics version
Windows version
Please send more comments and enhancement suggestions!!!!
---------------------------------------------------------------------------
ZCE & ZD v1.2 Users' Manual 7.0 - Future Versions of ZCE & ZD